Dynamic Gauge

Last updated: July 10, 2020

Widget size: 1 x 1, 2 x 1

This widget displays a single value and units of a point or points, as a graphical representation of a gauge.

Up to 6 gauges can be displayed at once within the widget. If there are alarm levels against the point(s), they will be displayed as a coloured background on the gauge scale(s).

Click on any of the gauge graphics and the widget will drill down to an Engineering Chart of data for the point(s), or to a Dashboard or Report (depending upon widget configuration).

Customisation

Widget Configuration – The following configuration affects the whole widget.

Value	Default	Comment
Widget Heading	Gauge (1x1)	Enter the name of the widget as it is to appear in the heading.
Period Selection	Dashboard/Report Selector	If Dashboard/Report Selector is selected, then the value of each gauge, relates to the period specified in the dashboard period selector, aggregated as per the "Data Aggregation" setting. The 2nd option is Last Values. If this is selected then the last value of each point(s) (regardless of dashboard period selector) is aggregated as per the "Data Aggregation" setting. Which points are included in these aggregations will be dependent upon the site/container selected in the dashboard navigation tree.
Data Aggregation	Sum	If the "Period Selection" is set to Dashboard/Period Selector then the "Data Aggregation" gives either a Sum, Average, Maximum, Minimum, or Last Value for the period specified in the Dashboard Period Selector, for all points configured in each row (segment). If the "Period Selection" is set to Last Values then the "Data Aggregation" gives either a Sum, Average, Maximum, Minimum, or Last Value regardless of the dashboard period selector, for all points configured in each row (segment). If a single row (gauge) has points that span multiple sites, then choosing a "Data Aggregation" of Last Value will give an average of the last values of the points configured for that row. The last values used will either be the last values for the period (if "Period Selection"=Dashboard/Report Selector), or the last value from all the point data (if "Period Selection"=Last Values). Which points are included in these aggregations will be dependent upon the container selected in the dashboard navigation tree.
Refresh Period	0	Select a refresh period from the drop-down menu, from between 15 sec to 1 hr, or no refresh at all.

Row Configuration - The following configuration is done on an individual row (gauge) basis. Each row can be set independently of another.

Value	Default	Comment
Show Alarm Levels	Yes	Yes or No, to show any configured alarm levels as coloured backgrounds to the gauges. Min gauge reading > Low Fault = Dark Red Low Fault > Low Alert = Blue Low Alert > High Alert = Green High Alert > High Alarm = Blue High Alarm > High Fault = Red High Fault > Max gauge reading = Dark Red
Gauge Label	Point Name	Choose between Point Name (the name of the point as it appears in the treeview), Asset Name (the name of the parent container of the point), or Custom (any custom text). If Custom is selected then the "Custom Label" configuration must be completed.
Custom Label	None	Enter the custom text, if "Custom Label" is configured.
Gauge Min	0	The Min value for the gauge.
Gauge Max	100	The Max value for the gauge.
Drilldown	Engineering Chart	Choose between a drilldown to Engineering Chart, a drilldown to a dashboard, a drilldown to a report, or no drilldown at all (the default).
Dashboard List	blank	A list of all the dashboards the user has access to.
Reports List	blank	A list of all the reports the user has access to.
Date Format	yyyy-MM-dd HH:mm	Set the date format to be displayed underneath the gauge. See "Date Format" below for full list of options.

Properties

Row 1 – Row 6. Each row corresponds to an individual gauge.

Click the plus icon to add additional rows.

Enter PointIDs of points to appear as gauges in the widget.

Points over multiple sites can be configured, and the gauges will update as each site/container is selected by the dashboard navigation treeview. For multi-site configuration, unless the points per row share the same point names, then using a custom "Label" for each row would be required.

Date Format

The default date format is yyyy-MM-dd HH:mm.

yyyy	The year showing all digits (e.g., 2015)
yyy	The year showing only the least significant 2 digits (e.g., 15 for the year 2015)
y	The year showing only the least significant 1 digits (e.g., 5 for the year 2015)
mmm	The month formatted as its name. The default is to use the first 3 characters of the English month name (Jan, Feb, Mar ...).
mm	The month formatted as 2 digits from 01 - 12, adding leading zero if necessary.
m	The month formatted using the minimum number of digits from 1 - 12.
MMM	The first 3 characters of the month name converted to upper case.
MM	The first 2 characters of the month name converted to upper case.
M	The first character of the month name converted to upper case.
dd	The day of month formatted as 2 digits from 01 - 31, adding leading zero if necessary.
d	The day of month formatted using the minimum number of digits from 1 - 31.
w	The name of the day of week. The default is to use the first 3 characters of the English day of week name (Sun, Mon, Tue ...).
hh	The hour of day formatted as 2 digits, adding leading zero if necessary. The 2 digits will be 00 - 23 if the 'a' option (see below) is not specified, otherwise it will be 01 - 12.
h	The hour of day formatted using the minimum number of digits. The digits will be 0 - 23 if the 'a' option (see below) is not specified, otherwise it will be 01 - 12.
nn	The minute formatted as 2 digits from 00 - 59, adding leading zero if necessary.
n	The minute formatted using the minimum number of digits from 00 - 59.
ss	The second formatted as 2 digits from 00 - 59, adding leading zero if necessary.
s	The second formatted using the minimum number of digits from 00 - 59.
a	Display either 'am' or 'pm', depending on whether the time is in the morning or afternoon.